package com.zenithmind.exam.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.zenithmind.exam.pojo.entity.WrongQuestion;
import com.zenithmind.exam.pojo.vo.QuestionVO;

import java.util.List;

/**
 * 错题本服务接口
 * 
 * @author ZenithMind
 * @since 2024-07-01
 */
public interface WrongQuestionService extends IService<WrongQuestion> {

    /**
     * 添加错题
     * 
     * @param userId 用户ID
     * @param questionId 题目ID
     * @param examRecordId 考试记录ID
     * @return 添加结果
     */
    boolean addWrongQuestion(String userId, String questionId, String examRecordId);

    /**
     * 标记题目为已掌握
     * 
     * @param userId 用户ID
     * @param questionId 题目ID
     * @return 标记结果
     */
    boolean markAsMastered(String userId, String questionId);

    /**
     * 标记题目为未掌握
     * 
     * @param userId 用户ID
     * @param questionId 题目ID
     * @return 标记结果
     */
    boolean markAsNotMastered(String userId, String questionId);

    /**
     * 获取用户错题列表
     * 
     * @param userId 用户ID
     * @return 错题列表
     */
    List<QuestionVO> getUserWrongQuestions(String userId);

    /**
     * 获取用户已掌握的错题列表
     * 
     * @param userId 用户ID
     * @return 已掌握的错题列表
     */
    List<QuestionVO> getUserMasteredQuestions(String userId);

    /**
     * 分页查询用户错题
     * 
     * @param page 分页参数
     * @param userId 用户ID
     * @param isMastered 是否已掌握
     * @return 分页结果
     */
    IPage<QuestionVO> getUserWrongQuestionPage(Page<WrongQuestion> page, String userId, Integer isMastered);

    /**
     * 统计用户错题数量
     * 
     * @param userId 用户ID
     * @param isMastered 是否已掌握
     * @return 错题数量
     */
    Integer countUserWrongQuestions(String userId, Integer isMastered);

    /**
     * 获取高频错题
     * 
     * @param userId 用户ID
     * @param limit 限制数量
     * @return 高频错题列表
     */
    List<QuestionVO> getFrequentWrongQuestions(String userId, Integer limit);

    /**
     * 获取最近错误的题目
     * 
     * @param userId 用户ID
     * @param limit 限制数量
     * @return 最近错误的题目列表
     */
    List<QuestionVO> getRecentWrongQuestions(String userId, Integer limit);

    /**
     * 清空用户错题本
     * 
     * @param userId 用户ID
     * @return 清空结果
     */
    boolean clearUserWrongQuestions(String userId);

    /**
     * 批量标记为已掌握
     * 
     * @param userId 用户ID
     * @param questionIds 题目ID列表
     * @return 批量标记结果
     */
    boolean batchMarkAsMastered(String userId, List<String> questionIds);

    /**
     * 获取用户错题的题目ID列表
     * 
     * @param userId 用户ID
     * @param isMastered 是否已掌握
     * @return 题目ID列表
     */
    List<String> getUserWrongQuestionIds(String userId, Integer isMastered);

    /**
     * 统计题目错误次数
     * 
     * @param questionId 题目ID
     * @return 错误次数
     */
    Integer getQuestionWrongCount(String questionId);

    /**
     * 生成错题练习
     * 
     * @param userId 用户ID
     * @param count 题目数量
     * @return 练习题目列表
     */
    List<QuestionVO> generateWrongQuestionPractice(String userId, Integer count);

    /**
     * 获取错题统计信息
     * 
     * @param userId 用户ID
     * @return 统计信息
     */
    WrongQuestion getWrongQuestionStatistics(String userId);
}
